home *** CD-ROM | disk | FTP | other *** search
/ AGA Toolkit '97 / The AGA Toolkit '97.iso / graphics / misc / managecdpics1.303 / managecdpics.doc < prev    next >
Text File  |  1996-09-07  |  10KB  |  312 lines
  1. Document ManageCDPics
  2.  
  3. ManageCDPics - © 1994/95 by Markus Hillenbrand
  4. ----------------------------------------------
  5.  
  6. ManageCDPics (short: MCDP) is a program to create some kind of picture
  7. database. You can easily have a look at pictures stored in several
  8. databases. The program was written to be mainly used for compact disks.
  9.  
  10.  
  11. 1. Requirements
  12. ~~~~~~~~~~~~~~~
  13. You need:    - intuition.library    v37
  14.         - gadtools.library    v37
  15.         - graphics.library    v37
  16.         - dos.library        v37
  17.         - exec.library        v37
  18.         - utility.library    v37
  19.         - icon.library        v37
  20.         - datatypes.library    v39 (only for the slideshow)
  21.         
  22. You should also have enough datatypes installed on your system, if you 
  23. want to use the slideshow.
  24.  
  25.  
  26. 2. Configuration
  27. ~~~~~~~~~~~~~~~~
  28.  
  29. The program can be configured by editing the tooltypes of the program´s
  30. icon. Currently the following tooltypes are supported:
  31.  
  32.     JPG=...        enter the name of the viewer for JPGs
  33.     GIF=...        enter the name of the viewer for GIFs
  34.     PHOTO=...    enter the name of the viewer for Photo-CD pictures
  35.     MPEG=...    enter the name of the viewer for MPEG streams
  36.     OTHER=...    enter the name for any other format
  37.  
  38. These tooltypes can be overridden by ENV: variabled:
  39.  
  40.     MCDPics_G = the same as GIF    in tooltypes
  41.     MCDPics_J = the same as JPG    in tooltypes
  42.     MCDPics_P = the same as PHOTO  in tooltypes
  43.     MCDPics_M = the same as MPEG   in tooltypes
  44.     MCDPics_O = the same as OTHER  in tooltypes
  45.  
  46. This is useful for users who start it from a write protected disk
  47. (i.e. a compact disk).
  48.     
  49. The tooltypes SM_xxx_xxx and SM_HIGHER can be edited, too. But it is 
  50. recommended to change them by using the program´s built in menu entry
  51. 'save prefs'.
  52.  
  53. The following tooltypes do only affect the slideshow part of the program:
  54.  
  55.     IGNOREERRORS    delete the brackets '(' and ')' if you do not
  56.             want the program to stop a slideshow when an
  57.             error occurs. An error can be low memory or
  58.             a deletet file, that cannot be loaded.
  59.             add  bracket '(' and ')' if you want to stop
  60.             a slideshow when an error occurs.
  61.  
  62.     DEBUG        if this is enabled (i.e. no brackets, see above)
  63.             the program will open a window where detailed
  64.             error messaged will be printed if an error occurs.
  65.  
  66.     OWNSCREENMODES    if this is enabled, the gadget 'define own screen-
  67.             modes' will be enabled by default.
  68.  
  69.  
  70. 3. The Program
  71. ~~~~~~~~~~~~~~
  72.  
  73. If you start the program, you can see three listviews and several gadgets.
  74. In the left listview you can select the database you want to have a look
  75. at. The middle one represents the categories in this database. Third there
  76. are the entries in these categories: the pictures.
  77.  
  78. The text gadget in the middle of the window is used to show some text 
  79. related to the picture which is active.
  80.  
  81. Underneath the first listview there is a string gadgets that contains the
  82. calls of the external viewers for the pictures. The contents of this gadgets
  83. depends on the suffix of the picture: if the suffix is '.gif' the call 
  84. defined via the tooltype GIF=... will be shown, if the suffix is '.JPG' the
  85. call for JPGs will be inserted, otherwise there will appear the entry for
  86. OTHERS=... You can change the entries everytime; but don´t forget the '%s':
  87. it will be replaced by the name of the picture. Any change of the entry will
  88. remain until you end the program. You can save your entries by using the menu
  89. 'save prefs'.
  90.  
  91. Next there is a cycle gadget. You can specify 'CD', 'Category' and 'Picture'.
  92. If you select category, all pictures that follow the active one in the third
  93. listview (including the actual) will be affected by your further actions.
  94. If you select CD the whole database will be affected, if you select picture,
  95. only the actual picture is beeing affected.
  96.  
  97. The last gadget is a button. If you click here the picture(s) will be shown
  98. using the external viewer(s).
  99.  
  100.  
  101. 4. The Menus
  102. ~~~~~~~~~~~~
  103.  
  104. The are two menus attached to the window. The 'Program' and the 'Special' menu.
  105. In the 'Program' menu you can save the prefs, see an about requester or quit
  106. the program.
  107.  
  108. The 'Special' menu lets you enter the slideshow part of the program.
  109.  
  110.  
  111. 5. The Slideshow
  112. ~~~~~~~~~~~~~~~~
  113.  
  114. A new window pops up containing several gadgets:
  115.  
  116. Define Own Screenmodes:    If active, the program forces the pictures
  117.             into a specified screenmode (see below).
  118.             This is especially useful for graphic cards.
  119.             If you check this gadget, you can specify
  120.             your screenmodes in the list above.
  121.             Every picture with a resolution smaller or 
  122.             equal the dimensions printed in front of the
  123.             text gadgets will be forced to use a screen
  124.             with the new screenmode.
  125.  
  126. Loop:            If this is active, the program won't stop if
  127.             the end of the category or database is reached,
  128.             it will start from the beginning.
  129.  
  130. Time Delay:        0     = wait for mousebutton to show next picture
  131.             3-300 = wait n seconds until showing next picture
  132.  
  133. Start Sildeshow:    well, it's obvious!
  134.             Once you've started the slide show you can stop it
  135.             by pressing the button in the window that appears
  136.             or by sending a CTRL_C to the program's task.
  137.             This slideshow will use the datatypes.library for
  138.             decoding pictures. You will have to install the 
  139.             right classes for the pictures you want to slide.
  140.  
  141.  
  142. 6. The Database Format
  143. ~~~~~~~~~~~~~~~~~~~~~~ 
  144.  
  145. - All data files must be located in a subdirectory called 'CDS'.
  146.  
  147. - First you have to give the root of your path:
  148.  
  149.     ROOT
  150.         CD0:
  151.     END
  152.  
  153.   Note: Before CD0: you must enter a TAB, no space.
  154.  
  155. - Then you define the categories:
  156.  
  157.        CATEGORIES
  158.         xx
  159.         yy
  160.         ...
  161.     END
  162.  
  163.    Note: Before xx you must enter a TAB, no space.
  164.  
  165. - Then you must define the directory names belonging to every category:
  166.  
  167.           CALLS
  168.         xx-dir
  169.         yy-dir
  170.         ...
  171.     END
  172.  
  173.    Note: Before xx-dir you must enter a TAB, no space.
  174.  
  175. - Now you define the pictures for every category:
  176.  
  177.        xx-dir
  178.         pic1
  179.         description.1
  180.         pic2
  181.         description.2
  182.         ...
  183.     yy-dir
  184.         picx
  185.         description.x
  186.         picy
  187.         description.y
  188.         picz
  189.         description.z
  190.         ...
  191.  
  192.    Note: Before pic.. you must enter a TAB, no space.
  193.          You need not enter END here.
  194.  
  195. Just have a look at the files in CDS, and you will understand how it 
  196. works.
  197.  
  198.  
  199. 7. The Script MakeNewDataBase
  200. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  201.  
  202. This tool allows you to easily create a new database for the program.
  203. You  can scan directories which must be organized this way:
  204.  
  205.     - All pictures must be placed in subdirectories.
  206.     - only one depth of subdirs is allowed, a subdir of a subdir
  207.           won´t cause trouble, but no pics will be recognized.
  208.     - All files must be pictures, other files are added too.
  209.  
  210. Anyway you can try out the script; it will create something useful, or
  211. you may throw it away and create your database by hand.
  212.  
  213. CAUTION: If the script doesn´t work, please have a look at the protection
  214.          bits of the file 'script.2'; there must appear an 's'. If there
  215.          is no 's', just type in your shell: 'protect script.2 s add',
  216.          and everything should work fine.
  217.  
  218.  
  219. 8. The Program DTShow
  220. ~~~~~~~~~~~~~~~~~~~~~
  221.  
  222. This program uses datatypes.library to view pictures. You'll need OS3.0
  223. and the monitor drivers 'SUPER72' and 'EURO72' and 'MULTISCAN' installed.
  224. Special Feature: Small pics will be shown in the middle of a screen!!!
  225.  
  226.  
  227. 9. The Author
  228. ~~~~~~~~~~~~~
  229.  
  230. Here is my address (bug-report, suggestions or something like that, and the 
  231. postcard):
  232.  
  233.     Markus Hillenbrand
  234.     Hauptstrasse 6
  235.     36124 Eichenzell-Löschenrod
  236.     GERMANY
  237.  
  238.     Tel.: 06659/3176 (Sa-Su) or 0631/99698 (Mo-Fr)
  239.  
  240.     e-mail: m_hillen@informatik.uni-kl.de
  241.  
  242.  
  243. 10. Copyright
  244. ~~~~~~~~~~~~~
  245.  
  246. **********************************************************************
  247. *                                                                    *
  248. *   T   H   I   S          P   R   O   G   R   A   M         I   S   *
  249. *                                                                    *
  250. *    #####   ####   #####   #####   #     #   ####   #####   #####   *
  251. *   #       #    #  #    #  #    #  #     #  #    #  #    #  #       *
  252. *   #       #    #  #    #  #    #  #     #  #    #  #    #  #       *
  253. *   #       ######  #####   #    #  #     #  ######  #####   ###     *
  254. *   #       #    #  # #     #    #  #  #  #  #    #  # #     #       *
  255. *   #       #    #  #  #    #    #  # # # #  #    #  #  #    #       *
  256. *   #       #    #  #   #   #    #  ##   ##  #    #  #   #   #       *
  257. *    #####  #    #  #    #  #####   #     #  #    #  #    #  #####   *
  258. *                                                                    *
  259. **********************************************************************
  260.  
  261. Since version 1.2, MCDP is CARDWARE. So you'll have to send me a postcard
  262. of your country/home/city/... with a few words from you (in your own
  263. language ?) if you use MCDP regularly.
  264.  
  265. MCDP is Copyright (C) 1994 Markus Hillenbrand and it's freely distributable
  266. as long as all of its files are included in their original form without
  267. additions, deletions, or modifications of any kind, and only a nominal fee
  268. is charged for its distribution. This software is provided *AS IS* without
  269. warranty of any kind, either expressed or implied. By using MCDP, you agree
  270. to accept the entire risk as to the quality and performance of the program.
  271.  
  272. Of course, it was tested rather extensively before it was released...
  273.  
  274.  
  275. 11. Thanks
  276. ~~~~~~~~~~
  277.  
  278. - Marcus Flehmig for beta-testing
  279. - Stephan Sürken for his program 'Text2Guide'
  280. - Christoph Feck for his JFIF datatype
  281.  
  282.  
  283. 12. History
  284. ~~~~~~~~~~~
  285.  
  286. v1.0:    first official release
  287. v1.1:    added cycle gadget for CD, category, single
  288.     added some databases
  289.     new icons
  290. v1.2:    added slideshow
  291.     added documents
  292.     some bugfixes
  293.     added some databases
  294. v1.301: special version for 'Amiga Tools & Demos'
  295. v1.303: Added support for Photo-CD pictures
  296.     Added support for MPEGS
  297.  
  298.  
  299. 13. Future Plans
  300. ~~~~~~~~~~~~~~~~
  301.  
  302. - localization
  303. - program 'EasySlide' for the shell
  304. - thumbnails
  305. - better handling of databases
  306. - appwindow for adding pictures
  307. - sorting of pictures, categories, CDs
  308. - better support for HAM pictures in combination with graphic cards
  309.  
  310. And remember: the more cards I get, the faster I will write a new 
  311.               version of the program.
  312.